home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 August / Macworld (1997-08).dmg / Shareware World / Utilities / User Interface / Neatnik / Neatnik Manual / Neatnik Manual.rsrc / TEXT_128.txt < prev    next >
Text File  |  1997-06-16  |  11KB  |  119 lines

  1.  
  2. What is Neatnik?
  3.  
  4. Neatnik is a utility for neatening up folder windows.
  5.  
  6. Say you have a disk. Now say that when you start 
  7. opening the folders in that disk, you want their 
  8. windows to appear on the desktop in a neat ‚Äúcas-
  9. cading‚Äù order. That is, ‚ÄúTest folder‚Äù appears 
  10. near the top of your screen, and ‚ÄúTest sub folder‚Äù, 
  11. which is contained in ‚ÄúTest folder‚Äù, appears 
  12. slightly down and to the right of ‚ÄúTest folder‚Äù, 
  13. and  ‚ÄúTest sub sub folder‚Äù, which is in ‚ÄúTest sub 
  14. folder‚Äù, appears slightly down and to the right of 
  15. that one, and so on, like so:
  16.  
  17. You can set up the disk like this by hand, by open-
  18. ing each folder and positioning it, opening and 
  19. positioning the folders within that folder, and so 
  20. on. Or you can let Neatnik do it for you automatically.
  21.  
  22. ‚ÄúHey waitaminute! Who the heck cares enough about folder windows to want a program that positions them automatically??‚Äù
  23. Well, Neatnik might not have absolutely universal appeal, but it would be a mistake to dismiss it too lightly. As the bulk of data that we all have to contend with increases exponentially, any tool that helps us to organize our handling of that data becomes increasingly useful, even vital. Neatnik is one such tool.
  24.  
  25. Some specific groups of users will find Neatnik particularly helpful. Those whose work involves a great deal of folder-navigation -- perhaps on disks received from other users -- will find Neatnik an indispensable tool for keeping things... well... neat! Producers of CD-ROM and other on-disk publications could also use Neatnik to process the master copy of their disks before duplication, to ensure that the disk‚Äôs folders will open in orderly and predictable locations on the end user‚Äôs desktops.
  26.  
  27. Granted, Neatnik may not be for everyone; but many will find it useful, and some will find it essential!
  28.  
  29.  
  30. Minimum Requirements:
  31.  
  32. Neatnik requires the scriptable Finder. The Finder in System 7.5 and later is scriptable, provided the extension ‚ÄúFinder Scripting Extension‚Äù is included in your Extensions folder (this extension is part of a normal system installation). System 7.6 and later do not require the extension.
  33.  
  34.  
  35. How to use Neatnik:
  36.  
  37. Launch Neatnik and select ‚ÄúPreferences...‚Äù under the File menu. Here you will set up exactly how your folder windows will appear when they are opened. There are a lot of options to set in the Preferences dialog, so I‚Äôll go through them from top to bottom, with occasional illustrations.
  38.  
  39. First are two ‚ÄúOffset...‚Äù items, which look like this:
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52. With the first of these you set ‚ÄúOffset from ‚Äòparent‚Äô window‚Äù, as you can see. A parent window is defined as the window of the folder that contains the current folder. You set the offset in the Preferences dialog by editing the two numbers (both 20 in the illustration). These set the horizontal and vertical offset in pixels, and the change will be reflected in the representation of the windows in the Preferences display.
  53.  
  54. The second offset item is for ‚ÄúOffset of ‚Äòsibling‚Äô windows‚Äù (this is not shown in the illustration). Sibling windows are defined as the windows of folders that reside within the same ‚Äúparent‚Äù folder. When a parent folder contains more than one sibling folder, you might want these siblings to open in different positions from one another. You might want this offset to be small ‚Äî just enough so that the sibling windows don‚Äôt completely cover and hide each other. If you want sibling windows to open in the same position, set the two offset numbers to zero.
  55.  
  56.  
  57. The next item in the Preferences dialog is a pair of radio buttons:
  58.  
  59.  
  60.  
  61.  
  62.  
  63. With ‚ÄúWindows to ‚ÄòZoomed‚Äô size‚Äù selected, Neatnik will set your windows to the size the Finder considers optimum ‚Äî just big enough to show the contents without scrolling. Neatnik will depart from the true ‚ÄúZoomed‚Äù size in some cases however: First, it will clip the window on the right and bottom if this is necessary to keep the window from extending past the edges of the monitor. Second, if the ‚Äúview‚Äù of the window is one of the list views (view by name, size, date, etc.) then Neatnik will shorten the width of the window so that is is wide enough to show only the name, size and kind.
  64. With ‚ÄúWindows to parent window‚Äôs size‚Äù, Neatnik will make all windows the same size as the window of the item you selected to be neatened. This will be the top level window of a disk if you selected a disk, or the window of the folder if you selected a folder.
  65.  
  66. Next in the Preferences are three check boxes:
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74. ‚ÄúHide Finder while working‚Äù does just that. While Neatnik is processing folders, it actually tells the Finder to open each window, set its size, position and other parameters, and then close it. If ‚ÄúHide Finder‚Äù is checked, most of this exciting action will be hidden from you. Since this means that the windows don‚Äôt have to be drawn to the screen, Neatnik should run a little faster this way. Un-check this box and you can watch Neatnik and the Finder do their thing. If you find this more than slightly entertaining, take that as a sign that you should get out more often.
  75.  
  76. Note: Even with ‚ÄúHide Finder‚Äù checked, there will still be a fair amount of action on your screen while Neatnik is working. ‚ÄúZoom rects‚Äù will zoom hither and yon, and any icons visible on your Desktop will disappear and reappear as the Finder needlessly erases and redraws them. (This second item is true with the System 7.5.x Finder; later versions of the Finder may not do this.)
  77.  
  78. ‚ÄúAdopt ‚ÄòView‚Äô setting of parent window‚Äù is pretty obvious. If this is checked, all folders will be given the same ‚ÄúView‚Äù setting (as in ‚ÄúView by Icon‚Äù, ‚ÄúView by Name‚Äù, etc.) as the top level of the folder or disk you selected to be neatened. If unchecked, the View setting of windows won‚Äôt be changed.
  79.  
  80. ‚ÄúDon‚Äôt change window if it‚Äôs already in position‚Äù is a bit harder to explain. When Neatnik is about to work with a folder, it first checks the current position of its window. If it is already at the position that Neatnik would have moved it to, and if you have this checkbox checked, Neatnik won‚Äôt do anything with that window. This will primarily be useful when you‚Äôre processing a disk or folder with Neatnik and that disk or folder has been processed before. After processing it the first time, you might go through it and change the View setting of a window or two, for example. You might also add some new folders, and want these additions to be neatened. You can process the folder or disk again, and Neatnik won‚Äôt change back the View settings of those windows that you changed manually, if their position is still ‚Äúcorrect‚Äù in Neatnik‚Äôs evaluation. The new folders, and any folders that you moved, will be processed as usual. Neatnik will reprocess an already-processed folder or disk much more quickly with this setting turned on, as it will be able to skip most of the work it normally does with each folder.
  81.  
  82. The last item in the Preferences dialog is this popup menu:
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93. As mentioned above, when Neatnik is positioning windows, it may become necessary to make them smaller than their ideal size in order to keep them from extending past the edges of your monitor. Neatnik will take care of this detail for you. In some situations, you may want to the windows to be sized appropriately for a monitor other than your own. If you‚Äôre neatening a disk that will be distributed to a wide audience, you can tell Neatnik to keep windows within the boundaries of one of the more common monitor sizes, rather than using the boundaries of your own monitor for reference. With this popup set to ‚Äúthis‚Äù monitor, Neatnik will crop windows to fit on the system it‚Äôs running on. Furthermore, if Neatnik is running on a multiple monitor system, it will take into account the available screen space on all available monitors.
  94.  
  95. Note: Neatnik may reach a point where it becomes unreasonable to make windows any smaller in order to fit then on the screen. If this happens, Neatnik will stop offsetting windows at that folder level. If there are any folders nested deeper than that maximum ‚Äúreasonable‚Äù level, their windows will simply be given the maximum allowable offset.
  96.  
  97.  
  98. Preferences Are All Set; Now What?
  99.  
  100. Once you have Neatnik‚Äôs preferences set, you can process some disks or folders. Before doing this, you should open the item you want to process, and set the position and other properties of its window appropriately, keeping in mind that all the folders within this disk or folder will have their properties set according to this ‚Äúparent‚Äù window. You can select an item to be neatened by using ‚ÄúSelect Folder or Disk...‚Äù under Neatnik‚Äôs File menu, or you can drag the icon of a folder or disk onto Neatnik‚Äôs icon in the Finder. Neatnik will then go to work, displaying its progress in a window.
  101.  
  102. ‚ÄúOdds Bodkins!! It‚Äôs really slow!!‚Äù
  103. Well, yeah, it is. Neatnik works by sending Apple Events to the Finder, and these Apple Events, and the Finder‚Äôs response to them, are slow. There‚Äôs not much I (the programmer of Neatnik) can do about that. If you want Neatnik to process your 2GB hard drive, you might want to take a coffee break. If you want it to process the master copy of your 27GB DVD disk, you‚Äôd better leave it running overnight. Unfortunately, Neatnik can‚Äôt be switched to the background while it‚Äôs working. In case you‚Äôre wondering, Neatnik is accelerated for Power Macs.
  104.  
  105.  
  106. History of Neatnik:
  107.  
  108. As it says in the About box, Neatnik was programmed by me, Karl Bunker, under contract to Ted Van Duyn. In other words, Ted came to me and said ‚ÄúI want a program that will do such-and-such‚Äù (describing Neatnik), and I said ‚ÄúOkay, it will cost you $so-and-so‚Äù (describing a sum of money). Then Ted generously gave me permission to distribute the finished product. Since I was working under contract to Ted, he had all rights to the copyright and ownership of Neatnik, but he chose to give it away so that others might have a little neatness brought into their lives. Nice guy, huh? Credit for most of the design of Neatnik belongs to Ted as well.
  109.  
  110.  
  111. Price of Neatnik:
  112.  
  113. Neatnik is emailware. If you want to use it, just send an e-mail to Karl Bunker (address below) with a return e-mail address. If you register in this way, you will be informed of future updates to Neatnik. To find the current version of Neatnik, visit the Web site at the URL below.
  114. Neatnik may be distributed by any means, as long as this documentation file is distributed with it and no fee is charged for it.
  115.  
  116. Karl Bunker
  117. KarlBunker@aol.com
  118. http://users.aol.com/karlbunker/
  119.